home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1995 November / EnigmA AMIGA RUN 02 (1995)(G.R. Edizioni)(IT)[!][issue 1995-11][Skylink CD].iso / earcd / misc / sexehead.lha / SEXeHeader.doc.fw (.txt) < prev    next >
Final Write Document  |  1995-09-24  |  32KB  |  190 lines
  1. SEXeHeader V2.0
  2.  
  3. MS Windows (Bindoze) New Executable (NE) header reader
  4.  
  5. ©Copyright 1995 Soyeb Aswat
  6.  
  7. FreeWare
  8.  
  9. 22/9/95
  10.  
  11.  
  12.  
  13. Introduction
  14.  
  15. SEXeHeader is the first stage in a project I am working on which will culminate 
  16. in a program that will allow you to run a MS Windows application on your Amiga 
  17. as if it were made for AmigaOS originally. This is with all the Amiga's 
  18. wonderful multitasking abilities and without the Windows resource hogging!
  19.  
  20. The next stage of this project is an 80386 dissasembler which will dissasemble 
  21. Windows NE executable files and dynamic link libraries (DLL). This will be 
  22. followed by the actual emulator to run Windows programs.
  23.  
  24.  
  25. Requirements
  26.  
  27. An Amiga!
  28. Workbench 2.04
  29.  
  30. Usage
  31.  
  32.     
  33. SEXeHeader Name/A STDIO/S
  34.  
  35. Stdio switch is to allow you to output the information on shell window enabling 
  36. output redirection to a file.
  37.  
  38.  
  39. What does it do!
  40.  
  41. SEXeHeader takes a Windows executable or library file as input and displays 
  42. it's header details in an understandable manner. In other words it looks at the 
  43. details the linker has put in the file to tell the loader how to load and run 
  44. it. Some very interesting things can be found in this data.
  45.  
  46.  
  47. Why do it?
  48.  
  49. Why have a program to look at Windows files on an Amiga I hear you ask. Well as 
  50. can be seen from the introduction I am working on a Windows emulator, *not* a 
  51. PC emulator but a Windows emulator. To do this I have to decipher Microsoft 
  52. ducumentation which is very ambiguous, confusing and has great omissions.
  53.  
  54. The best way to find this out in my opinion was to write my own program to do 
  55. something and compare the output to a similar program already available. 
  56. SEXeHeader's output was compared to Turbo Dump from Borland, Mapwin from 
  57. PharLap Technologies and EXEdump from the writers of Undocumented Windows. The 
  58. dissasemblers output will be compared to similar dissasemblers I have in my 
  59. posession on the PC and the final emulator will be compared to Windows itself!
  60.  
  61. From making SEXeHeader I was able to clear up much of the confusion and 
  62. ommisions I found in the Microsoft ducumentation for the Windows NE file 
  63. format.
  64.  
  65.  
  66. Future
  67.  
  68. I will continue to develop this program as much as I need so don't expect new 
  69. versions. I have included the source for all to ogle at and improve on.
  70.  
  71.  
  72. Bugs
  73.  
  74. None that I have found but I am sure there are some. Send me a detailed 
  75. description of the bug describing your system, programs running etc, and 
  76. preferably a copy of the file that caused the problem to show up.
  77.  
  78. NOTE
  79.  
  80. If you make any improvements or bug fixes please send them to me FIRST do not 
  81. release any "improved" versions. This is not to oppress your creativity but to 
  82. allow the currently available version of SEXeHeader to be the best available. 
  83. This also stops some versions having features that others don't etc.
  84.     
  85. All improvements made by you will be fully credited.
  86.  
  87.  
  88. Windows emulator
  89.  
  90. If you are interested in any of my future projects please send me some mail to 
  91. let me know. Depending on the amount of interest shown I will put effort into 
  92. producing the software.
  93.  
  94.  
  95. Author
  96.  
  97. Soyeb Aswat
  98. 37 Newick Road,
  99. Clapton,
  100. London,
  101. E5 0RP,
  102. UK.
  103.  
  104. e-mail: df114@city.ac.uk
  105.  
  106. If you use this program or even just download it out of curiosity (catchy name 
  107. isn't it!) send me an e-mail or a postcard or something so I know if anybody's 
  108. out there! If you have any questions comments bug reports or just want somebody 
  109. to talk to write to me.
  110.  
  111.  
  112. Liscence
  113.  
  114. This program can be freely distributed on the condition that the archive stays 
  115. in its original form. No modifications are made to the program, documentation 
  116. and associated files. The source is provided for reference only and is not 
  117. intended to reflect the operation of the provided executable.
  118.     
  119. You may change and recompile the source to your specifications but I shall 
  120. retain the copyright on this and any subsequent versions of the program  and 
  121. will be subject to the conditions above. Any improvements made should be sent 
  122. to me and if included in following software, improvements will be fully 
  123. credited to you. Under no circumstances should adjusted copies be distributed 
  124. without my prior consent.
  125.     
  126. No gurantees are made as to the suitability, functionality or accuracy of the 
  127. software to any purpose whatsoever. No guarantee is made to the accuracy of the 
  128. documentation as relating to the software or otherwise.
  129.     
  130. No resposibility is taken for damages caused through the use or misuse of the 
  131. program of any sort whatsoever whether direct or consequential, whether 
  132. physical, financial or any other form.
  133.  
  134.  
  135. References
  136.  
  137. Microsoft Windows 3.1 Programmer's reference Volume 4
  138. Microsoft Press    ISBN: 1-55615-494-1
  139. Contains the NE file format among many others. Typical Microsoft documentation, 
  140. confusing and containing many omissions, only there to keep the lawyers happy 
  141. and stop themfrom being investigated for monopolising. Despite all this 
  142. absolutely essential.
  143.  
  144. Microsoft Windows 3.1 Guide to programming
  145. Microsoft Press    ISBN:
  146. As above. Best thing is to get the complete set of programmers reference guides 
  147. which are available with the Microsoft Windows 3.1 Software Development Kit 
  148. (SDK) Probably be hard to get hold of now but if you have a copy PLEASE TELL 
  149. ME!!!!!!
  150.  
  151. Undocumented Windows : a programmer's guide to reserved Microsoft Windows API 
  152. functions
  153. by Andrew Schulman, David Maxey, Matt Pietrek
  154. Addison-Wesley    ISBN: 0-201-60834-0
  155. Invaluable source of information for insulting Windows, also contains many 
  156. usful descriptions of both documented and undocumented functions etc.
  157.  
  158.  
  159. History
  160.  
  161. 1.0
  162.     
  163. 19/9/95
  164.     
  165. First version, works on any Amiga
  166.  
  167. 2.0
  168.     
  169. 22/9/95
  170.     
  171. Revised version which opens its own output window unless
  172.     
  173.     
  174.     
  175. specfically instructed not to, useful for redirecting output to a file.
  176.     
  177.     
  178.     
  179. Proper command line parsing courtesy of ReadArgs function.
  180.     
  181.     
  182.     
  183. Ctrl-C support added.
  184.     
  185.     
  186.     
  187. Named version 2.0 due to the requirement of Workbench 2.0
  188.  
  189.  
  190.